/*
 * Copyright [2022] [https://www.xiaonuo.vip]
 *
 * Snowy采用APACHE LICENSE 2.0开源协议，您在使用过程中，需要注意以下几点：
 *
 * 1.请不要删除和修改根目录下的LICENSE文件。
 * 2.请不要删除和修改Snowy源码头部的版权声明。
 * 3.本项目代码可免费商业使用，商业使用请保留源码和相关描述文件的项目出处，作者声明等。
 * 4.分发源码时候，请注明软件出处 https://www.xiaonuo.vip
 * 5.不可二次分发开源参与同类竞品，如有想法可联系团队xiaonuobase@qq.com商议合作。
 * 6.若您的项目无法满足以上几点，需要更多功能代码，获取Snowy商业授权许可，请在官网购买授权，地址为 https://www.xiaonuo.vip
 */
package vip.xiaonuo.biz.modular.wall_image.service;


import com.mybatisflex.core.paginate.Page;
import com.mybatisflex.core.service.IService;
import org.noear.solon.core.handle.UploadedFile;
import vip.xiaonuo.biz.modular.wall_image.entity.BizWallImage;
import vip.xiaonuo.biz.modular.wall_image.param.BizWallImageAddParam;
import vip.xiaonuo.biz.modular.wall_image.param.BizWallImageEditParam;
import vip.xiaonuo.biz.modular.wall_image.param.BizWallImageIdParam;
import vip.xiaonuo.biz.modular.wall_image.param.BizWallImagePageParam;

import java.util.List;

/**
 * 壁纸信息Service接口
 *
 * @author KingTiger
 * @date  2025/05/27 15:44
 **/
public interface BizWallImageService extends IService<BizWallImage> {

    /**
     * 获取壁纸信息分页
     *
     * @author KingTiger
     * @date  2025/05/27 15:44
     */
    Page<BizWallImage> page(BizWallImagePageParam bizWallImagePageParam);

    /**
     * 添加壁纸信息
     *
     * @author KingTiger
     * @date  2025/05/27 15:44
     */
    void add(BizWallImageAddParam bizWallImageAddParam);

    /**
     * 添加壁纸信息(批量)
     * @param categoryId
     * @param file
     */
    void addBatch(String categoryId, UploadedFile file);
    /**
     * 编辑壁纸信息
     *
     * @author KingTiger
     * @date  2025/05/27 15:44
     */
    void edit(BizWallImageEditParam bizWallImageEditParam);

    /**
     * 删除壁纸信息
     *
     * @author KingTiger
     * @date  2025/05/27 15:44
     */
    void delete(List<BizWallImageIdParam> bizWallImageIdParamList);

    /**
     * 获取壁纸信息详情
     *
     * @author KingTiger
     * @date  2025/05/27 15:44
     */
    BizWallImage detail(BizWallImageIdParam bizWallImageIdParam);

    /**
     * 获取壁纸信息详情
     *
     * @author KingTiger
     * @date  2025/05/27 15:44
     **/
    BizWallImage queryEntity(String id);

    /**
     * 数据转换
     * @param bizWallImage
     */
    void tranBizWallImage(BizWallImage bizWallImage);

    /**
     * 根据ID获取URL
     * @param id
     * @return
     */
    String getUrlById(String id);

}
